home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Netware Super Library
/
Netware Super Library.iso
/
menu_pgm
/
mnu126b
/
manual.txt
< prev
next >
Wrap
Text File
|
1990-05-04
|
134KB
|
3,878 lines
The Mnu
Version 1.26
The Mnu programs and accompanying documentation are
Copyright (c) 1989 Bonsai Technologies. All rights reserved.
The Mnu is a trademark of Bonsai Technologies.
Novell is a registered trademark of Novell, Inc.
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1 - Mnu Basics . . . . . . . . . . . . . . . . . . . 2
Program Modules . . . . . . . . . . . . . . . . . . . . 2
Mnu Objects . . . . . . . . . . . . . . . . . . . . . . 2
Chapter 2 - Mnu Configuration . . . . . . . . . . . . . . . . 5
Help in MnuCon . . . . . . . . . . . . . . . . . . . . . 5
MnuCon Operation . . . . . . . . . . . . . . . . . . . . 5
Main Menu . . . . . . . . . . . . . . . . . . . . . . . 6
Group Information . . . . . . . . . . . . . . . . . 7
Group Selection List . . . . . . . . . . . . . 7
Edit Group . . . . . . . . . . . . . . . . . . 7
Full Name (7); Group Members (7);
Summary (7)
Item Information . . . . . . . . . . . . . . . . . 9
Item Selection List . . . . . . . . . . . . . 9
Edit Item . . . . . . . . . . . . . . . . . . 9
Authorized Groups & Users (10); Default
Drive (10); Description (10); Drive
Mapping (11); Execution Method (11);
Instructions (13); Menus Used In (14);
Prohibited Groups & Users (14); Summary
(15)
Menu Information . . . . . . . . . . . . . . . . . 16
Edit Menu . . . . . . . . . . . . . . . . . . 16
Authorized Groups & Users (17);
Description (17); Menu Structure (17);
Menus Used In (17); Prohibited Groups &
Users (17); Screen Position (18);
Summary (18)
Other Information . . . . . . . . . . . . . . . . . 19
Allow Escape to DOS (19); Auto Logout
Item (19); Auto Logout Timeout (20);
Base Menu (20); Display Station Number
(20); Screen Saver Timeout (20);
Separate Menus from Items (20); Summary
(20)
Program Information . . . . . . . . . . . . . . . . 22
Program Selection List . . . . . . . . . . . . 22
Edit Program . . . . . . . . . . . . . . . . . 22
Default Drive (23); Description (23);
Drive Mapping (23); License Info (23);
Search Path (23); Summary (23)
User Information . . . . . . . . . . . . . . . . . 24
Group Selection List . . . . . . . . . . . . . 24
Edit Group . . . . . . . . . . . . . . . . . . 24
Full Name (24); Groups Belonged To (24);
Security Equivalences (25); Summary (25)
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Reports . . . . . . . . . . . . . . . . . . . . . . 26
Complete System Configuration (26); Menu
Structure (26); Mnu Configuration (26);
Netware Configuration (26)
Chapter 3 - The Wadget Example . . . . . . . . . . . . . . . 27
Appendix A - License Agreement . . . . . . . . . . . . . . . 39
Appendix B - Registration Information . . . . . . . . . . . . 41
Appendix C - Program Support . . . . . . . . . . . . . . . . 47
Appendix D - Hints . . . . . . . . . . . . . . . . . . . . . 48
Appendix E - Technical Information . . . . . . . . . . . . . 49
Bindery Usage . . . . . . . . . . . . . . . . . . . . . 49
Environment variables . . . . . . . . . . . . . . . . . 49
CGA Snow & BW w/Color Video . . . . . . . . . . . . . . 49
License Control . . . . . . . . . . . . . . . . . . . . 50
Work Files . . . . . . . . . . . . . . . . . . . . . . . 50
Dos Versions . . . . . . . . . . . . . . . . . . . . . . 51
Netware Version . . . . . . . . . . . . . . . . . . . . 51
Multiple File Servers . . . . . . . . . . . . . . . . . 51
Item Execution . . . . . . . . . . . . . . . . . . . . . 51
Appendix F - Cautions . . . . . . . . . . . . . . . . . . . . 55
Appendix G - Installation . . . . . . . . . . . . . . . . . . 57
Appendix H - Future Enhancements . . . . . . . . . . . . . . 59
Appendix I - Version History . . . . . . . . . . . . . . . . 60
Appendix J - System Config Report . . . . . . . . . . . . . . 62
Appendix K - Upgrade Instructions . . . . . . . . . . . . . . 63
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Introduction Page 1
Introduction
----------------------------------
The Mnu is a menu system designed specifically for use with
Novell. It was designed to be a logical extension of Novell's
security system of Users, Groups and Trustees. In addition,
program operation was designed to be very similar to Novell's
existing Menu Utilities; i.e., MnuCon (The Mnu Configuration)
operates very similarly to SysCon (System Configuration). The
Mnu does not replace any of Novell's utilities, except for the
Novell Menu, but rather works hand in hand with them.
If you are familiar with the concepts of Novell's Groups and
Users, you will have no problem with the concepts of The Mnu's
Menus, Items and Programs. The Mnu, for all it capabilities and
flexibility, really is a very simple program.
If you are familiar with Novell's SysCon and other utilities, you
will have no problem navigating in MnuInst and MnuCon, as they
were designed to use the same user interface.
The best way to become familiar with The Mnu is:
1) Skim Chapter 1 - Mnu Basics to get some background
info.
2) Read Chapter 3 - The Wadget Example to get an idea of
what The Mnu can do (not necessarily how it does it).
If you are still interested (I hope you are!):
3) Skim Chapter 2 - Mnu Configuration to get a general
idea of what you are going to do after The Mnu is
installed.
4) Install The Mnu on your file server using Appendix G -
Installation.
5) Set up a simple version of you current menus using
Chapter 2 - Mnu Configuration as a reference (or, use
the context-sensitive help).
I hope you find The Mnu to be a valuable addition to your
network! One other note, while The Mnu is a complete product as
it is, it is continually evolving. Take a look at Appendix H and
see if any of the things mentioned there interest you, then let
me know! Also, let me know if there are other things that you
would like to see. The Mnu was, is, and will be, designed and
written to meet your needs.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 1 - Mnu Basics Page 2
Chapter 1 - Mnu Basics
----------------------------------
Program Modules Program Modules
The Mnu consists of three modules:
MnuInst Mnu Installation (MNUINST.EXE,MNU$HLP.HLP)
MnuCon Mnu Configuration (MNUCON.EXE,MNU$HLP.HLP)
Mnu The Mnu (MNU.BAT,MNU$MAIN.EXE)
MnuInst is used to initially install The Mnu on a file server,
enter registration information and update existing Mnu data.
Please note that you must be SUPERVISOR equivalent to run this
module.
MnuCon works with Menus, Items and Programs in much the same way
that SysCon works with Users and Groups. Please note that you
must be SUPERVISOR equivalent to run this module.
Mnu is the user interface module. It is the module that each
user will run to access the menu system.
Mnu Objects Mnu Objects
Items
An Item is simply a choice that appears on a user's
menu. For example: Set Password, Word Processing,
Logout.
You may specify which groups and/or users are
authorized to use an item. In addition, you may
specifically prohibit groups and/or users from using an
item. Also, you must specify which Menus the item is to
appear on; i.e., Word Processing would appear on the
Applications menu, Set Password would appear on the
Netware Utilities menu, Logout would appear on the main
menu.
Drive Mapping may be specified by an option; i.e., for
Word Processing, drive F: could be mapped to the WP
subdirectory off the user's personal directory and
drive G: could be mapped to a common data area. In
conjunction with the Data drives, a Default Drive may
be specified, so the item is executed with a specific
drive letter as the default drive.
The Program that the Item uses may also be specified.
This will allow a search path to the program files to
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 1 - Mnu Basics Page 3
be setup and also any data drives that the program
needs. Also, license metering may optionally be
utilized.
Items may also be used to standardize a set of
instructions across other items through the use of Item
Instructions. For example, you might set up an item
called LASER_CAP to perform a printer capture to your
laser printer. In the instructions for LASER_CAP, you
enter the appropriate capture commands. Then in the
instruction for your SPREADSHEET item, you insert an
Item instruction before the Text instruction that loads
your spreadsheet program. When The Mnu encounters the
Item instruction during execution of SPREADSHEET, it
inserts all of the instructions from LASER_CAP. Please
note that in this case Authorization and Prohibition
are ignored for Item LASER_CAP (but not for Item
SPREADSHEET).
Menus
A Menu is similar to an Item in that you authorize and
prohibit groups and users. Also, you specify which
menus the Menu is to appear in. However, a Menu does
not execute any programs or perform other actions and
thus does not have Drive Mappings or Instructions. In
a typical setup, you might have a Main Menu, an
Applications Menu and a Netware Utilities Menu. The
Applications Menu and the Netware Utilities Menu would
be used in the Main Menu.
Programs
A Program is used to provide centralized license
control, search path mapping and data drive mapping.
For example, if you have an accounting system that has
three modules, GL, AR and AP, you would setup a Program
called ACCTING that has a search path to where all the
executables are and a Data Drive to where the
centralized data files are kept. Then you would make
separate items for GL, AR and AP that all have ACCTING
as the Program Used. If you later move the data and/or
program files, you simply change the Search Path and
Drive Mapping for the Program and the Items are
affected automatically.
The license metering feature may be used to allow
single-user programs to run on a network; i.e., the
above accounting system is single-user and will not
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 1 - Mnu Basics Page 4
allow multi-user access to the data files. Simply
specify the number of licenses as 1 on the Program and
only one person will be allowed into the accounting
system at the same time (you must also use the Exec
execution method for this to work). Note that this
setup, 1 program and multiple items, would not allow a
user to access GL if another user is in AP, since both
items use the same program.
The other application of the license metering feature
is that it allows you to purchase fewer licenses for a
program than the number of users on your network
without violating your license agreement; i.e., on a 10
user network, you may buy 5 word processing licenses
and use the license metering feature to only allow 5
users to use the program at the same time.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 5
Chapter 2 - Mnu Configuration
----------------------------------
Help in MnuCon Help in MnuCon
MnuCon has an online context-sensitive help system. Whenever you
need more information on something, simply press F1.
The Help Text is organized as an information tree which gets more
and more specific as you move through it. The following is a
guide to interpreting the Help screens:
The topic behind "::" is the title of the current page.
The topics behind ">>" are more specific help.
The topics behind "<<" is more general help.
Any highlighted text may be selected by moving the selection
bar with the cursor keys and striking enter.
Highlighted text will generally appear after the ">>" and
"<<" symbols. However, it will occasionally appear in the
text also.
MnuCon Operation MnuCon Operation
MnuCon consists of a series of menus and list selections.
When in a menu, use the up/down arrow keys to move among the
options. Options that have a Quick-Select character will have
that character highlighted. If you hit the Quick-Select character
for an option, the cursor will move to that option. After the
cursor is on your desired option, hit enter to execute the
option.
When in a list selection, use the up/down arrows, home/end,
pgup/pgdn to move the cursor through the options. Also, you may
hit the first letter of an option, this will take you to the
first option in the list with that first letter except if the
current option has that first letter, it will take you to the
next option with that first letter.
In addition to the cursor movement keys, one of more of the
following may be active in a list selection: Enter, Delete,
Insert, Mark(F5), Modify(F3). Hit the Help key while in the list
to find out which keys are active.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 6
Main Menu Main Menu
The Main Menu consists of the following options:
Group This option will allow you add, delete,
Information and edit Groups. The operations performed
here are identical to those in SysCon.
Item This option will allow you to add, delete,
Information and edit Items.
Menu This option will allow you to add, delete
Information and edit Menus.
Other This option will allow you to edit The
Information Mnu's configuration information, such as
the Base Menu, the Automatic Logout
Timeout, whether or not to display the
Station Number on the screen title, etc.
Program This option will allow you to add, delete
Information and edit Programs.
Reports This option will allow you to
print/display system-wide reports.
User This option will allow you to edit
Information information pertaining to Users. The
operations performed here are identical to
those in SysCon. Note that you cannot add
or delete Users with this option, those
functions must be performed in SysCon.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 7
Group Information Group Information
Selecting Group Information will bring up a List Selection of
Groups. The functions here duplicate those available in SysCon.
From this list you may Add, Edit, Modify or Delete Groups.
Group Selection List
The Group Selection List has the following keys active:
o Enter Edit the Group under selection bar.
o Delete Delete Group under selection bar or delete
all marked Groups.
o Mark (F5) Mark/unmark Group under selection bar.
o Modify (F3) Change the name of the Group under the
selection bar.
o Insert Create a new Group.
Edit Group
After you have selected a Group from the Group Selection List,
the Edit Group menu is presented with the following options
available:
Full Name This option will allow to give the group a
descriptive name.
Group Members This option will allow you to add/delete
users to/from this Group.
Summary This option will allow you to
display/print a summary of this group.
Full Name
The Full Name is only used to print reports. It has no impact on
program operation. It does not need to be unique; i.e., two
groups may have the same Full Name. The Full Name may consist of
upper/lower case, spaces and punctuation. This is the same Full
Name that may be manipulated with SysCon.
Group Members
The Group Members information is used in many ways, both by The
Mnu and by Netware. This is the same Group Members that may be
manipulated with SysCon.
Summary
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 8
Summary will display/print a summary of the Group being edited.
This Summary includes the Group's Full Name, Group Members and
Trustee Assignments.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 9
Item Information Item Information
Selecting Item Information will bring up a List Selection of
Items. From this list you may Add, Edit, Modify or Delete Items.
Item Selection List
The Item Selection List has the following keys active:
o Enter Edit the Item under selection bar.
o Delete Delete Item under selection bar or delete all
marked Items.
o Mark (F5) Mark/unmark Item under selection bar.
o Modify (F3) Change the name of the Item under selection
bar.
o Insert Create a new Item.
Edit Item
After you have selected an Item from the Item Selection List, the
Edit Item menu is presented with the following options available:
Authorized This option allows you to specify which
Groups Groups are authorized to use this Item.
Authorized This option allows you to specify which
Users Users are authorized to use this Item.
Default Drive This option allows you to specify a
Default Drive letter for the Item to use
as the default/current drive during
execution.
Description This options allows you to specify a
Description for this Item. This
Description is similar to Groups' & Users'
Full Names.
Drive Mapping This option allows you to specify the
Drives that will be mapped when the Item
executes.
Execution This option allows you to specify an
Method execution method for this item. There are
several choices available, each with it's
own strong points relating to memory
overhead, license metering support, etc.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 10
Instructions This option allows to specify the
Instructions that this Item will use when
it executes.
Menus Used In This option allows you to specify which
Menus this Item will appear in.
Prohibited This option allows you to specify which
Groups Groups will be Prohibited from using this
Item.
Prohibited This option allows you to specify which
Users Users will be Prohibited from using this
Item.
Program Used This option will allow you specify which
Program this Item uses, if any.
Summary This option will display/print a summary
of this Item.
Authorized Groups & Users
The Authorized Groups & Users is used to determine if an item
will appear on a user's menu. There are three ways a user may be
authorized to use an Item:
1) The user is in the Authorized Users list.
2) The user is security equivalent to a User that is in
the Authorized Users list.
3) The user is a member of a Group that is in the
Authorized Groups list.
Note that making a user security equivalent to another user does
not transfer group membership (just like Netware Trustee
Assignments). Also see Prohibited Groups & Users.
Default Drive
This option will allow you to select the drive letter of the
default drive during execution. If a default drive is not
specified, the user drive will be the default drive.
Note that if the Item uses a Program that has a Default Drive
specified, the Default Drive that you specify for the Item will
override the Program's Default Drive.
Description
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 11
This option allows you to specify a Description that will be used
when the item appears on a menu. The default Description is the
Item Name (as it appears in the Item Information List). The
Description is similar to Full Names for Groups and Users. It
may be any combination of upper/lower case, numbers, spaces and
punctuation. It does not have to be unique (two items may have
the same Description). In addition, this option allows you to
specify a QuickSelect character. This character will appear
highlighted on menus and may be used to move to the item with one
keystroke. Note that this character must be specified in the
same case (upper/lower) as it appears in the Description. Also,
if the character appears more that once in the Description, the
first occurrence will be used. Specify a space if you do not
want a Quick Select character for this item.
Drive Mapping
This option will allow you to specify drive mapping for data
drives.
Note that Item Drive Mapping overrides Program Drive Mapping for
any Drive Letters that are used in both the Item and Program.
Execution Method
This option allows you to specify the Execution Method for the
Item. The following Execution Methods are available:
Shell Very fast execution & return to menu, one
line instructions only, relatively high
memory overhead (75-150k), license control
is available.
Shell&Pause Same as Shell, except program pauses
before it clears the screen and returns to
the menu.
Exec Fast execution & return to menu, multiple
line instructions, low memory overhead
(10k), license control is available.
Exit Fast exit from the Menu to DOS.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 12
Batch Execution and return to menu is slower
than other methods. License control is not
available. This methods only purpose for
existence is that there is no (0) memory
overhead and so is suitable for
loading/unloading TSR's and for running
programs that won't tolerate even a 10k
memory overhead.
Batch & Exit Same as Batch except that the menu is not
restarted after the item is done
executing. The method is suitable for
exiting to a local hard drive or starting
another menu system (why would anyone
would want to use anything but The Mnu?).
Logout Same as Batch except that after the item
is done executing, MNU$LOG.BAT is called
to log the user out of the network.
This is a table summarizing these methods:
Shell Batch
Method: Shell &Pause Exec Batch &Exit Exit Logout
----- ------ ---- ----- ----- ----- ------
Mem OverHead 75k 75k 10k 0k 0k N/A 0k
Load TSR No No No Yes Yes N/A Yes
License Ctrl Yes Yes Yes No No N/A No
ExecSpeed Fast Fast Slow Slow Slow Fast Slow
ReturnSpeed Fast Fast Fast Slow N/A N/A N/A
Multi Instr No No Yes Yes Yes N/A Yes
PauseOnReturn No Yes No No N/A N/A N/A
Return to Mnu Yes Yes Yes Yes No No No
Shell
This method is well suited for executing interactive programs
that do not need a lot of memory to run.
This method yields the best turn-around speed since the Mnu does
not need to be unloaded from memory, however it only executes one
instruction line. If more than one instruction line is needed,
use the Exec method. This method does provide license control.
Shell & Pause
This method is the same as Shell except that it pauses for a
keystroke before that screen is cleared and the menu restarted.
It well suited for use with non-interactive programs such as
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 13
ChkVol and Dir because it pauses and waits for the user to hit a
key before overwriting the screen with the Mnu.
Exec
This method will be used for the great majority of items. It has
a low memory overhead, license control and the return to the menu
is almost instantaneous.
It is slightly slower than the Shell methods because of the
additional file i/o involved in multiple-line instructions and
swapping the menu's memory space. It is much faster at returning
to the menu than the Batch method because it does not have to
reread all of the item and menu information from the file server.
Batch
This method is best for loading and unloading TSR's. The
execution speed is similar to Exec but it's return to menu speed
is greatly impacted, since all item and menu information must be
reread from the file server. License control is NOT available
with this method. This method may also be used for programs that
will not tolerate the 10k memory overhead of the Exec method.
Batch & Exit
This method is the same as the Batch method except that the Mnu
is not reloaded after execution. It may be used to transfer
control to a local hard disk.
Exit
This method is used to provide an exit to dos capability for non-
supervisor equivalent users when the Allow Escape to Dos is set
to No. Note that supervisor-equivalent users may always escape
from the base menu to dos, regardless of the setting of Allow
Escape to Dos. Any item instructions are ignored.
Logout
This method is used to provide a logout capability for items. It
is somewhat more flexible than the Novell Menu !Logout because it
uses the MNU$LOG.BAT file to logout. This file may be modified
to provide a continuous login loop, or display instructions about
how to log back into the network. Also, MNU$LOG.BAT calls
LOGOUT.EXE to actually log out, so the login statistics are
displayed. ~
Instructions
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 14
This option will allow you to add,edit and delete the
Instructions for this Item. Instructions may be straight text
and may include instructions from other items. These
instructions are normal DOS batch commands. User prompting for
parameters may be done with same syntax as the Novell Menu -- put
a '@' in the instruction, followed by the prompt in '"'s. For
example, to do a copy:
copy @"Source file spec" @"Destination file spec"
The Instruction List has the following keys active:
o Enter Edit the Instruction under selection bar.
o Delete Delete Instruction under selection bar.
o Insert Create a new Instruction. The new Instruction will
be placed immediately before the Instruction under
the selection bar.
Menus Used In
This option will allow you to specify which Menus this Item will
appear on. You may also specify that this Item will appear on a
Menu by using the Menu Structure in Menu Information.
Prohibited Groups & Users
The Prohibited Groups & Users is used in conjunction with
Authorized Groups & Users to determine if an item will appear on
a user's menu. For an item to appear on a user's menu, the user
must first be authorized (see requirements in Authorized Groups &
Users) and second, the user must NOT be prohibited. There are
three ways a user may be prohibited to use an Item:
1) The user is in the Prohibited Users list.
2) The user is security equivalent to a User that is in
the Prohibited Users list.
3) The user is a member of a Group that is in the
Prohibited Groups list.
Note that making a user security equivalent to another user does
not transfer group membership (just like Netware Trustee
Assignments).
Program Used
This option will allow you to specify which program will be used
by this item. Specifying a program to be used will cause the
program's search drives to be mapped when the item is executed.
It also enables license control when the program has it enabled
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 15
and when a compatible execution method is used. In addition, the
programs data drives and default drive are used. If the item and
program have the same drive letter mapped, the item's mapping is
used. Also, if the item has a default drive specified (not a
space), the item's default drive is used.
Summary
Summary will display/print a summary of the Item being edited.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 16
Menu Information Menu Information
Selecting Menu Information will bring up a List Selection of
Menus. From this list you may Add, Edit, Modify or Delete Menus.
The Menu Selection List has the following keys active:
o Enter Edit the Menu under selection bar.
o Delete Delete Menu under selection bar or delete all
marked Menus.
o Mark (F5) Mark/unmark Menu under selection bar.
o Modify (F3) Change the name of the Menu under selection
bar.
o Insert Create a new Menu.
Edit Menu
After you have selected an Menu from the Menu Selection List, the
Edit Menu menu is presented with the following options available:
Authorized This option allows you to specify which
Groups Groups are authorized to use this Menu.
Authorized This option allows you to specify which
Users Users are authorized to use this Menu.
Description This options allows you to specify a
Description for this Menu. This
Description is similar to Groups' & Users'
Full Names.
Menus Used In This option allows you to specify which
Menus this Menu will appear in.
Menu Structure This option will allow you specify which
Items/Menus will appear on this Menu.
Prohibited This option allows you to specify which
Groups Groups will be Prohibited from using this
Menu.
Prohibited This option allows you to specify which
Users Users will be Prohibited from using this
Menu.
Screen Position This option will allow you specify where
the Menu should appear on the screen.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 17
Summary This option will display/print a summary
of this Menu.
Authorized Groups & Users
The Authorized Groups & Users is used to determine if a Menu will
appear on a user's menu. There are three ways a user may be
authorized to use an Menu:
1) The user is in the Authorized Users list.
2) The user is security equivalent to a User that is in
the Authorized Users list.
3) The user is a member of a Group that is in the
Authorized Groups list.
Note that making a user security equivalent to another user does
not transfer group membership (just like Netware Trustee
Assignments). Also see Prohibited Groups & Users.
Description
This option allows you to specify a Description that will be used
when the Menu appears on a menu. This Description will also be
used as the Menu's title when it is displayed on the screen. The
default Description is the Menu Name (as it appears in the Menu
Information List). The Description is similar to Full Names for
Groups and Users. It may be any combination of upper/lower case,
numbers, spaces and punctuation. It does not have to be unique
(two Menus may have the same Description). In addition, this
option allows you to specify a QuickSelect character. This
character will appear highlighted on menus and may be used to
move to the Menu with one keystroke. Note that this character
must be specified in the same case (upper/lower) as it appears in
the Description. Also, if the character appears more that once
in the Description, the first occurrence will be used. Specify a
space if you do not want a Quick Select character for this Menu.
Menu Structure
This option will allow you to specify which Menus and Items will
appear on this Menu.
Menus Used In
This option will allow you to specify which Menus this Item will
appear on. You may also specify that this Item will appear on a
Menu by using the Menu Structure in Menu Information.
Prohibited Groups & Users
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 18
The Prohibited Groups & Users is used in conjunction with
Authorized Groups & Users to determine if an Menu will appear on
a user's menu. For an Menu to appear on a user's menu, the user
must first be authorized (see requirements in Authorized Groups &
Users) and second, the user must NOT be prohibited. There are
three ways a user may be prohibited to use an Menu:
1) The user is in the Prohibited Users list.
2) The user is security equivalent to a User that is in
the Prohibited Users list.
3) The user is a member of a Group that is in the
Prohibited Groups list.
Note that making a user security equivalent to another user does
not transfer group membership (just like Netware Trustee
Assignments).
Screen Position
This option will allow you to specify where the menu will appear
on the screen. Both a Horizontal (Left,Center,Right) and a
Vertical (Upper,Middle,Lower) position may be specified. The
default is Middle,Center.
The menu will be centered in the specified area of the screen.
If the menu is too big to be centered in the given area, the
position will be adjusted automatically.
Summary
Summary will display/print a summary of the Menu being edited.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 19
Other Information Other Information
This option will allow you to edit global operation parameters
for The Mnu. After selecting this option the following options
will be presented:
Allow Escape to This option selects whether or not
DOS pressing Escape from the base menu will
exit to DOS.
Automatic If you wish to have an item execute when
Logout Item the Automatic Logout Timeout expires,
specify it here. If none is selected, the
user will still be logged out.
Automatic This option allows you to specify the
Logout Timeout number of minutes of inactivity before the
user is automatically logged out.
Base Menu This option allows you to specify a Menu
to be used as a system-wide Base Menu.
Display Station This option allows you to specify whether
Number or not to display the station number with
the user name in the screen title area.
Screen Saver This option allows you to specify the
Timeout number of minutes of inactivity allowed
before the screen is automatically
blanked.
Separate Menus This option allows you to specify whether
from Items or not Menus are separated from Items when
they are displayed on the screen.
Summary The option displays/prints this
information.
Allow Escape to DOS
This option will allow you to select whether or not to allow an
exit to DOS by pressing Escape from the main menu. Note that
Items with Execution Methods Exit or Batch & Exit will still exit
to DOS after execution. Also, please note that SUPERVISOR
equivalent users will always be able to escape to DOS from the
Main Menu.
Auto Logout Item
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 20
This option will allow you to select the Item to be used for
Automatic Logout. If you select <None>, the Automatic Logout
will still function but no Item Instructions will be used. Please
note that authorization checking is not performed for an
Automatic Logout item. You must use Auto Logout Timeout to
enable/disable the Automatic Logout.
Auto Logout Timeout
This option will allow you to select the Timeout for the
Automatic Logout. Use a value of 0 to disable the Automatic
Logout. The value is in minutes. The Automatic Logout is
operational only when executing the menu, not while in MnuCon or
MnuInst. Also, it is not operational while in an application
program.
Base Menu
This option will allow you to select the Base Menu. This is the
Menu that is used by the program as the "main menu". Please note
that everyone should be authorized to use this Menu.
Display Station Number
This option will allow you to select whether or not to display
the Station Number after the User Name in the Title Block on the
top of the screen. The Station Number is the current setting of
the DOS envvar MNU_STATION, which should be the Connection
Number.
Screen Saver Timeout
This option will allow you to select the Timeout for the
Automatic Screen Saver. Use a value of 0 to disable the
Automatic Screen Saver. The value is in minutes. The Automatic
Screen Saver is operational only when executing the menu, not
while in MnuCon or MnuInst. Also, it is not operational while in
an application program.
Separate Menus from Items
This option will allow you to select whether or not to separate
Menu choices from Item choices when they are presented to the
user. The separation consists of Sorting the Menus to the bottom
of the list and inserting a separating line when the menu is
presented to the user.
Summary
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 21
This option will display/print a summary of the this info.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 22
Program Information Program Information
Selecting Program Information will bring up a List Selection of
Programs. From this list you may Add, Edit, Modify or Delete
Programs.
Program Selection List
The Program Selection List has the following keys active:
o Enter Edit the Program under selection bar.
o Delete Delete Program under selection bar or delete
all marked Programs.
o Mark (F5) Mark/unmark Program under selection bar.
o Modify (F3) Change the name of the Program under
selection bar.
o Insert Create a new Program.
Edit Program
After you have selected a Program from the Program Selection
List, the Edit Program menu is presented with the following
options available:
Default Drive This option allows you to specify a
Default Drive letter for Items that use
this Program to use as the default/current
drive during execution.
Description This options allows you to specify a
Description for this Program. This
Description is similar to Groups' & Users'
Full Names.
Drive Mapping This option allows you to specify the
Drives that will be mapped when Items that
use this program execute.
License This option allows you to specify how may
Information license copies you own for this program.
Search Path This option allows to specify the path
where the executables for this program
reside. The Search Path will be mapped
when Items that use this Program execute.
Summary This option will display/print a summary
of this Program.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 23
Default Drive
This option will allow you to select the drive letter of the
default drive during execution. If a default drive is not
specified, the user drive will be the default drive.
Note that if an Item that uses this Program has a Default Drive
specified, the Default Drive that is specified for the Item will
override the Program's Default Drive.
Description
This option allows you to specify a Description for the
Program. The default Description is the Program Name.
Note that the Description for Programs is only used when printing
reports and will never be seen on a user's menu (since only Items
and Menus appear on user's menus).
Drive Mapping
This option will allow you to specify drive mapping for data
drives.
Note that Item Drive Mapping overrides Program Drive Mapping for
any Drive Letters that are used in both the Item and Program.
License Info
This option will allow you to edit the License Information for
the Program. The Number of Licenses sets the maximum number of
users that may use the Program simultaneously. Note that if the
Program is used from an Item with the Batch or Batch & Exit
execution methods, the License Information will be ignored.
Use 0 for an unlimited Number of Licenses.
Search Path
The search path specifies the location of the program files.
This path will be mapped to a search drive (usually X:). Specify
the full path including the volume name.
Summary
This option will display/print a summary of this Program.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 24
User Information User Information
Selecting User Information will bring up a List Selection of
Users. From this list you may Edit and Modify Users. These
functions duplicate those available in SysCon.
Note that you may not add or delete users, these functions must
be performed in SysCon.
Group Selection List
The Group Selection List has the following keys active:
o Enter Edit the Group under selection bar.
o Delete Delete Group under selection bar or delete
all marked Groups.
o Mark (F5) Mark/unmark Group under selection bar.
o Modify (F3) Change the name of the Group under the
selection bar.
o Insert Create a new Group.
Edit Group
After you have selected a User from the User Selection List, the
Edit User menu is presented with the following options available:
Full Name This option will allow to give the User a
descriptive name.
Groups Belonged This option will allow you to add/delete
To groups that this User belongs to.
Security This option will allow you to add/delete
Equivalences Security Equivalences for this User.
Summary This option will allow you to
display/print a summary of this User.
Full Name
The Full Name is only used to print reports. It has no impact on
program operation. It does not need to be unique; i.e., two
users may have the same Full Name. The Full Name may consist of
upper/lower case, spaces and punctuation. This is the same Full
Name that may be manipulated with SysCon.
Groups Belonged To
The Group Belonged To information is used in many ways, both by
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 25
The Mnu and by Netware. This is the same Groups Belonged To that
may be manipulated with SysCon.
Security Equivalences
The Security Equivalence information is used in many ways, both
by The Mnu and by Netware. This is the same Security Equals
information that may be manipulated with SysCon, except that you
cannot manipulate Group security equivalences with MnuCon while
you can with SysCon. However, MnuCon correctly maintains Group
security equivalence while using this option and while using the
Groups Belonged To option.
Summary
Summary will display/print a summary of the User being edited.
This Summary includes the User's Full Name, Groups Belonged To,
Security Equivalences, Login Script and Trustee Assignments.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 2 - Mnu Configuration Page 26
Reports Reports
This option will allow you to edit display/print reports on the
system-wide configuration. After selecting this option the
following options will be presented:
Complete System This option displays/prints a composite of
Configuration the Menu Structure, Mnu Configuration and
Netware Configuration reports.
Menu Structure This option displays/prints a report
illustrating the system-wide menu
structure.
Netware This option displays/prints a report of
Configuration all the information relating to Netware
(Users,Groups,Trustee Assignments,System
Login Script).
Complete System Configuration
This option will display/print a composite of the Menu Structure,
Mnu Configuration, and Netware Configuration reports. This
report is complete enough to file as a paper backup of both your
User/Group configuration and Mnu configuration.
Menu Structure
This option will display/print an illustration of the system-
wide menu structure, without regard to Authorization/Prohibition.
Mnu Configuration
This option will display/print a complete report of The Mnu's
information on your system. This report prints the equivalent of
a Summary report for all Items/Menus/Programs and a Summary of
Other Information.
Netware Configuration
This option will display/print a complete report of Netware's
User/Group information on your system. This report also prints
the System Login Script and all User Login Scripts. This report
prints the equivalent of a Summary report for all Users and
Groups.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 27
Chapter 3 - The Wadget Example
----------------------------------
Perhaps the best way to explain what The Mnu does is to use an
example. We will use the infamous Wadgets International
corporation. Appendix J contains the Complete System
Configuration report for this example.
Wadgets International has just installed a network in their
office. A workstation is on every desk, including George's, the
janitor. These are the employees:
President Ken Verybery
Sales Manager Ken Killum
Sales Robert Realslick
Yakov Wecandothat
Secretarial Sara Sweetness
Gloria Holley
Controller Jay Justjoshin
Accounting Mary Mixitup
Production Mike Gleeful
Manager
Production Charles Chuckster
Workers Andy Able
Jerry Kindaslow
Janitor George Geewhiz
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 28
The following applications will be used on the network:
Make Em Fast The production workers will need to Make Em Fast
production tracking use this program during the day to
and management enter information on what they are
doing.
The program consists of two modules,
FSTMAIN and FSTMGT.
The production manager will need
access to the management module to
make sure the production workers are
doing something.
Wadgets has an unlimited site license
for this program.
Almost Balanced Obviously, the accounting department Almost Balanced
accounting will need to use this program. Also,
the sales staff will need access to
the order entry portion of the
program.
The program consists of several
modules: GL (General Ledger),
PR (Payroll), AP (Accounts Payable),
AR (Accounts Receivable), and
OE (Order Entry). Also, this program
has very high memory requirements and
will not tolerate any memory overhead
over the network shell (it barely
handles the shell).
Wadgets has an unlimited site license
for this program.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 29
Count 143 Sales staff will need access to this Count 143
spreadsheet program so that they can run their
football pool.
Since this program costs $100,000.99
per copy, Wadgets could only afford
to buy 2 copies.
Words, Words, Words Everyone except the production Words, Words, Words
wordprocessing workers will need to use this
program.
Wadgets has a site license for 5
users.
Slow Blue The production manager will need this Slow Blue
emulation for blue program to access the mainframe that
mainframes controls the air conditioning in the
production area.
This program came with the Blue
gateway and has an unlimited site
license. However, the program will
lock-up if more users than the
gateway supports try to use it. The
gateway currently supports
one (1) user.
TP Tracker The janitor will need to use this TP Tracker
toilet paper program. Also, Jay Justjoshin will
tracking and need to use it to make sure John
ordering isn't ordering too much toilet paper
and selling it for pocket money.
This program comes free with each
case of toilet paper. Wadgets
currently has 553 copies. However,
the program is a single-user program
and will not allow multi-user access
to the data files.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 30
The following users and groups have been created on the network:
Users Groups
----------------------- ------------------------------
KV Ken Verybery SALES KK,YW,RR
KK Ken Killum SECRETARIES SS,GH
RR Robert Realslick ACCOUNTING JJ,MM
YW Yakov Wecandothat PRODUCTION MG,CC,AA,JK
SS Sara Sweetness MANAGEMENT KV,KK,JJ,MG
GH Gloria Hollering
JJ Jay Justjoshin
MM Mary Mixitup
MG Mike Gleeful
CC Charles Chuckster
AA Andy Able
JK Jerry Kindaslow
GG George Geewhiz
The following directory structure has been created:
SYS: --+-- SYSTEM
+-- PUBLIC ----- IBM_PC --- MSDOS --- V3.30
+-- LOGIN
+-- MNU_WORK
+-- USERS --+-- KV
| +-- KK
| +-- RR
| +-- YW
| +-- SS
| +-- GH
| +-- JJ
| +-- MM
| +-- MG
| +-- CC
| +-- AA
| +-- JK
| +-- GG
+-- DATA ---+-- TPTRACK
| +-- MAKEFAST
| +-- ALMSTBAL
+-- APPS ---+-- MAKEFAST
+-- ALMSTBAL
+-- COUNT143
+-- WWW
+-- SLOWBLUE
+-- TPTRACK
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 31
The system login script is:
* Remove any search maps or DOS Path
SET PATH=""
* Turn Map Display Off so we don't have to see unnecessary info
MAP DISPLAY OFF
* Map standard search drives and data drives
MAP S1:=SYS:PUBLIC
MAP S2:=SYS:PUBLIC\%OS\%OS_VERSION
SET COMSPEC=S2:COMMAND.COM
MAP F:=SYS:USERS\%LOGIN_NAME
* Map Mnu work and search drives and set Env vars for the Mnu
MAP INS S1:=SYS:APPS
MAP W:=SYS:DATA\MNU_WORK
DOS SET MNU_USER="F"
DOS SET MNU_WORK="W"
DOS SET MNU_SEARCH="X"
DOS SET MNU_STATION=STATION
Each Users login script is:
* Exit to The Mnu
EXIT "MNU"
We have decided that sufficient program security will be provided
by giving EVERYONE read-only (ROS) rights to the APPS
subdirectory (SYS:APPS). If we wanted more security for
individual programs, we would assign trustee rights to each of
the program subdirectories under APPS.
For data security, we have decided that security for each
subdirectory under DATA should be provided. Therefore, using
SysCon, we have created the following groups and assigned all but
parental rights per the following:
TP_TRACKER SYS:DATA\TPTRACK
ALMOST_BALANCED SYS:DATA\ALMSTBAL
MAKE_EM_FAST SYS:DATA\MAKEFAST
Also, we have assigned group members as:
TP_TRACKER JJ,GG
ALMOST_BALANCED KK,YW,RR,JJ,MM
MAKE_EM_FAST MG,CC,AA,JK
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 32
After installing The Mnu files and running MnuInst, we run
MnuCon.
First, we use the Menu Information option on the main menu to
create a Menu to be used as the base menu:
BASE_MENU
Description Wadgets Int'l Main Menu
Authorized Groups EVERYONE
Then we use the Other Information option on the main menu and
set:
Allow Escape to DOS Yes
Base Menu BASE_MENU
Next, we use the Program Information option to create the
following Programs:
MAKE_EM_FAST
Search Path SYS:APPS\MAKEFAST
License Info Number of Licenses=0
Data Drives (Abs)G:=SYS:DATA\MAKEFAST
Default Drive G
ALMOST_BALANCED
Search Path SYS:APPS\ALMSTBAL
Data Drives (Abs)G:=SYS:DATA\ALMSTBAL
Default Drive G
License Info Number of Licenses=0
COUNT_143
Search Path SYS:APPS\COUNT143
License Info Number of Licenses=2
WWW
Search Path SYS:APPS\WWW
License Info Number of Licenses=5
SLOW_BLUE
Search Path SYS:APPS\SLOWBLUE
License Info Number of Licenses=0
TP_TRACK
Search Path SYS:APPS\TPTRACK
License Info Number of Licenses=1
Data Drives (Abs)G:=SYS:DATA\TPTRACK
Default Drive G
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 33
Next, we use Item Information to create the following items:
MAKE_EM_FAST_MAIN
Authorized Groups PRODUCTION
Instructions (Txt)FSTMAIN
Program Used MAKE_EM_FAST
Description Make Em Fast
Execution Method Exec
MAKE_EM_FAST_MGT
Authorized Users MG
Instructions (Txt)FSTMGT
Program Used MAKE_EM_FAST
Description Make Em Fast - Management
Execution Method Exec
ALMOST_BALANCED_GL
Authorized Groups ACCOUNTING
Instructions (Txt)GL
Program Used ALMOST_BALANCED
Description GL - General Ledger
Execution Method Batch
ALMOST_BALANCED_PR
Authorized Groups ACCOUNTING
Instructions (Txt)PR
Program Used ALMOST_BALANCED
Description PR - Payroll
Execution Method Batch
ALMOST_BALANCED_AP
Authorized Groups ACCOUNTING
Instructions (Txt)AP
Program Used ALMOST_BALANCED
Description AP - Accounts Payable
Execution Method Batch
ALMOST_BALANCED_AR
Authorized Groups ACCOUNTING
Instructions (Txt)AR
Program Used ALMOST_BALANCED
Description AR - Accounts Receivable
Execution Method Batch
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 34
ALMOST_BALANCED_OE
Authorized Groups ACCOUNTING, SALES
Instructions (Txt)OE
Program Used ALMOST_BALANCED
Description OE - Order Entry
Execution Method Batch
COUNT_143
Authorized Groups SALES
Instructions (Txt)COUNT
Program Used COUNT_143
Description Count 143
Execution Method Exec
WWW
Authorized Groups MANAGEMENT, SECRETARIES, SALES,
ACCOUNTING
Instructions (Txt)WWW
Data Drives (RelCre)F:=WWW
Default Drive F
Program Used WWW
Description Words, Words, Words
Execution Method Exec
SLOW_BLUE_LOAD
Authorized Users MG
Instructions (Txt)SB
Program Used SLOW_BLUE
Description Slow Blue Load
Execution Method Batch
SLOW_BLUE_UNLOAD
Authorized Users MG
Instructions (Txt)SB -U
Program Used SLOW_BLUE
Description Slow Blue Unload
Execution Method Batch
TP_TRACKER
Authorized Users GG, JJ
Instructions (Txt)SB -U
Program Used TP_TRACKER
Description TP Tracker
Execution Method Exec
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 35
After we have decided that all the items should appear on an
Applications Menu, except for the Accounting programs, which
should appear on a separate Accounting Menu, we use the Menu
Information option and create the following menus:
APPLICATIONS
Description Applications
Authorized Groups EVERYONE
Menu Structure MAKE_EM_FAST_MAIN(Item)
MAKE_EM_FAST_MGT(Item)
COUNT_143(Item)
WWW(Item)
SLOW_BLUE_LOAD(Item)
SLOW_BLUE_UNLOAD(Item)
TP_TRACKER(Item)
Menus Used In BASE_MENU
ACCOUNTING
Description Accounting
Authorized Groups SALES, ACCOUNTING
Menu Structure ALMOST_BALANCED_GL(Item)
ALMOST_BALANCED_PR(Item)
ALMOST_BALANCED_AP(Item)
ALMOST_BALANCED_AR(Item)
ALMOST_BALANCED_OE(Item)
Menus Used In BASE_MENU
This setup will result in the following menu structures:
Ken Verybery:
Wadgets Int'l Main Menu
Applications
Words, Words, Words
Ken Killum:
Wadgets Int'l Main Menu
Accounting
OE - Order Entry
Applications
Count 143
Words, Words, Words
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 36
Robert Realslick & Yakov Wecandothat:
Wadgets Int'l Main Menu
Accounting
OE - Order Entry
Applications
Count 143
Words, Words, Words
Sara Sweetness & Gloria Holley:
Wadgets Int'l Main Menu
Applications
Words, Words, Words
Jay Justjoshin:
Wadgets Int'l Main Menu
Accounting
AP - Accounts Payable
AR - Accounts Receivable
GL - General Ledger
OE - Order Entry
PR - Payroll
Applications
TP Tracker
Words, Words, Words
Mary Mixitup:
Wadgets Int'l Main Menu
Accounting
AP - Accounts Payable
AR - Accounts Receivable
GL - General Ledger
OE - Order Entry
PR - Payroll
Applications
Words, Words, Words
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 37
Mike Gleeful:
Wadgets Int'l Main Menu
Applications
Make Em Fast
Make Em Fast - Management
Slow Blue Load
Slow Blue Unload
Words, Words, Words
Charles Chuckster, Andy Able & Jerry Kindaslow:
Wadgets Int'l Main Menu
Applications
Make Em Fast
George Geewhiz:
Wadgets Int'l Main Menu
Applications
TP Tracker
Words, Words, Words
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Chapter 3 - The Wadget Example Page 38
After we turn the users loose, we soon have a few complaints:
Ken Verybery - I need to use the Almost Balanced GL to get
reports. Also, I think that Accounting and Management
should be able to use Count 143.
Sales staff - Why do I have to go back to the Accounting
menu just to get to OE? It would be easier if we could
get to OE from the Applications Menu.
It's now 11:00 am and everyone is busy on the network. But wait,
we don't need to get everyone off to make our changes! We load
MnuCon.
First, let's take care of Ken's GL. We use Item information and
add KV as an authorized object for ALMOST_BALANCED_GL. Also, Ken
will need access to the Accounting menu to get at the item, so we
add KV as an Authorized User for menu ACCOUNTING. That's that,
except we need to get Ken access to the accounting files.
Anticipating future requests from other management for access to
accounting, we use SysCon to make a trustee assignment for group
MANAGEMENT in SYS:DATA\ALMSTBAL. Our job is saved! We intercom
Ken and ask him to look at his menu. He turns on his machine and
logs in --- there it is!
OK, next we'll take care of Count 143. Still in MnuCon, we add
MANAGEMENT and ACCOUNTING to the Authorized Groups for the
COUNT_143 item.
Now we'll take care of the Sales Staff -- we add APPLICATIONS to
Menus Used In for the ALMOST_BALANCED_OE item. Mission
accomplished!
Note that this will make the Order Entry available on the
Application menu for everyone. If this becomes a problem, we will
remove SALES from the Authorized Groups for the
ALMOST_BALANCED_OE item and for the ACCOUNTING menu. Then we
would create an item:
ALMOST_BALANCED_OE_SALES
Authorized Groups SALES
Instructions (Txt)OE
Program Used ALMOST_BALANCED
Description OE - Order Entry
Execution Method Batch
Menus Used In APPLICATIONS
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix A - License Agreement Page 39
Appendix A - License Agreement
----------------------------------
Software License Agreement
The Mnu is not public domain software nor is it free software.
The Mnu program and all accompanying documentation is
Copyright (c) 1989 by Bonsai Technologies. All Rights Reserved.
Non-registered users are granted a limited license to install and
use The Mnu for a period not to exceed 21 days for the purpose of
determining its suitability for their needs. Use of The Mnu by
non-registered users, except for this purpose, is strictly
prohibited.
Registration grants the user a license to install and use the
program on a single file server. There is no restriction on the
number of workstations the program may be operated on
simultaneously provided that the above restriction of a single
file server is not violated. Registered users may make as many
archival copies as deemed necessary.
No user may modify The Mnu programs in any way, including, but
not limited to, decompiling, disassembling or otherwise reverse
engineering the programs.
All users are granted a limited license to copy and distribute
The Mnu to others subject to the following conditions:
Those who receive the program are subject to all conditions
of this license agreement.
The program may not be represented as being "Free" or
"Public Domain".
The program must be distributed in unmodified form, complete
with the file containing license information and full
program documentation.
No fee, charge or compensation may be accepted, given or
requested except a nominal charge not to exceed $10
Anyone who copies and distributes this program must also comply
with the above conditions. This includes, but is not limited to,
Dealers, Consultants, Distributors and BBS Sysops.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix A - License Agreement Page 40
Warranty Disclaimer
Bonsai Technologies hereby disclaims any and all warranties
relating to The Mnu, whether express or implied, including
without limitation any implied warranties of merchantability or
fitness for a particular purpose. Bonsai Technologies will not be
liable for any special, incidental, consequential, indirect or
similar damages due to loss of data or any other reason, even if
Bonsai Technologies has been notified of the possibility of such
damages. In no event shall Bonsai Technologies' liability for any
damages ever exceed the price paid for the license to use The
Mnu, regardless of the form of the claim. The person using The
Mnu bears all risk as to the quality and performance of The Mnu.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 41
Appendix B - Registration Information
----------------------------------
Registration
Shareware
-------------------------
Shareware is method of marketing software that allows you, the
user, to evaluate the software on your own system to determine
whether or not it meets your needs before you make an investment.
In addition, shareware allows authors to charge much less for
their programs than their retail counterparts because there are
little or no marketing expenses. Note that while both authors
and users benefit from successful shareware, that success is
entirely dependent on you. Your registration allows us to
continue supporting and enhancing the program.
The Mnu is a copyrighted program being marketed as shareware. It
is NOT public domain nor "freeware". If you decide to use The
Mnu after the 21-day evaluation period you are required to
register. Continued use of The Mnu after the evaluation period
is over is a violation of copyright law. Even if The Mnu does
not meet all of your needs, you must register IF you continue to
use the program after the 21-day evaluation period is over. Note
that while you are legally required to register, in practice you
are on your honor to register.
Price Schedule
-------------------------
Basic Registration $85 per server
Update Mail Service $20/yr
On registration, you will receive a perpetual license to use the
programs on one file server. You will also receive the most
current version of the program. You will be provided with a
serial number and registration code to entered onto your system
via MnuInst.
Update/Upgrade Policies
-------------------------
All updates are provided at no cost. Please note that an update
is a minor revision (ex. X.24 to X.25) and will normally contain
minor enhancements and bug fixes. All updates will be posted on
CompuServe and Indiana On-Line (tm). Registered users who did not
purchase the Update Mail Service will be notified via EasyPlex
when an update becomes available. Those who purchase the Update
Mail Service will have the update shipped to them automatically.
Upgrades will be available for an additional fee. Please note
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 42
that an upgrade is a major revision (ex. 1.XX to 2.XX) and will
contain major enhancements. Upgrade fees will be determined at
the time that the upgrade becomes available.
These policies and price schedule are current as of August 1,
1989. We reserve the right to change these policies and prices
at any time.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 43
The Mnu Registration Form
Name: ________________________________
Address: ________________________________
________________________________
City,State,Zip: ________________________________
Telephone:
Voice: (_____) _____ - ________
Fax: (_____) _____ - ______
CompuServe ID: _________,______
Licensee Name: ____________________________________________
*This should be your Company Name and will appear each time
the program is executed.
Current Version: ______
Where did you obtain your copy of the software?
___ CompuServe (NOVSOFT)
___ Indiana On-Line (tm) (INDIANA DIGITAL CORP.)
___ Bonsai Technologies
___ Another user
___ Dealer or Consultant: _______________________________
___ Other: ______________________________________________
I hereby certify that I have read the License Agreement and
Warranty Disclaimer and agree to the terms presented therein.
Signature: ______________________________ Date: _________
Name: ________________________ Title: ________________________
Enclosed is a check or money order for:
_X_ Basic Registration $85
___ Update Mail Service $20
___ Completed Survey Enclosed -$5
=========
Subtotal _______
MN Sales Tax(6%) _______ If applicable.
=========
Total Enclosed _______
Send to:
Bonsai Technologies
PO Box 6296
Rochester, MN 55903-6296
Thank-you for your business!
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 44
Attention: Dealers and Consultants
If you are a Dealer or a Consultant who would like to
provide this program to your customers/clients, please
contact us via Easyplex (73657,3203) for details about
special registration, finders fees and other services. Note
that while you may not charge (more than the nominal $10)
for the program itself, you may (and should) charge for
installation and maintenance.
Attention: Shareware Distributors
If you are a shareware distributor, please drop us a line
and let us know your address and approximate distribution
numbers. We will provide you with the mail update service
free of charge. Please be advised that this program will
ONLY work on a Novell Network and will be of no use
whatsoever to stand-alone users. Please note that to comply
with the license agreement you MUST:
1) distribute all documentation with the program
2) NOT charge more than a $10 fee for your services.
3) NOT represent the program as "Free" or "Public Domain"
If your distribution results in a significant number of
registrations, you will be eligible for a finders fee.
Attention: BBS Sysops
Please drop us a line and let us know your address and phone
number. We will provide you with the mail update service
free of charge. Please be advised that this program will
ONLY work on a Novell Network and will be of no use
whatsoever to stand-alone users. If your downloads result in
a significant number of registrations, you will be eligible
for a finders fee.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 45
Registration Survey
1) Network parameters:
Novell Netware version:
___ ELS II v2.12
___ ELS II v2.15
___ Advanced v2.10 or 2.11
___ Advanced v2.12
___ Advanced v2.15
___ SFT v2.10 or 2.11
___ SFT v2.12
___ SFT v2.15
___ Other: ___________
Number of servers on network (whether The Mnu is on one or all)
___ One
___ More that One, number ____
Number of workstations: ______
Number of users: _______
2) How long did you evaluate the program before registering it?
___ 10 days or less
___ 10 to 30 days
___ 30 days or more
3) What other menu systems have you used or considered?
4) What features do you find most important in The Mnu?
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix B - Registration Information Page 46
5) What features would you like to see in future versions of
The Mnu? Also, please rate each as Very Important,
Important, or Not Very Important.
6) Is the registration fee
___ Too high, should be: _____
___ Too low, should be: _____
___ About right
7) If this were a commercial program, how much would you be
willing to pay for it?
___ $100
___ $200
___ $500
___ $1000
8) Any other comments:
Thank-you for your time.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix C - Program Support Page 47
Appendix C - Program Support
----------------------------------
Program Support
Program support is available for both registered and non-
registered users. Presently, the best way to get support is
through EasyPlex on Compuserve or e-mail on Indiana On-Line (tm).
Phone support is not available currently. Mail support is also
available. Send your questions/concerns to:
Mark Pfeifer
Bonsai Technologies
PO Box 6296
Rochester, MN 55903-6296
CIS ID: 73657, 3203
The Mnu now has another official support and distribution point:
INDIANA ON-LINE (tm) Computer Bulletin Board - Bloomington, IN
Phone: (812) 332-RBBS (data) 300/1200/2400/9600-bps (HST & V.32)
Indiana On-Line (tm) is a service of Indiana Digital Corporation
Enter J)oin command from Main menu and select the MNU subboard!
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix D - Hints Page 48
Appendix D - Hints
----------------------------------
A couple of hints when using The Mnu:
Use of Groups: It has been my experience that
operational groups are easier to manage
than application groups; i.e., an
operational group would be SALES,
MANAGEMENT, etc. and an application
group would be COUNT_143, WWW, etc. Part
of the difficulty is that Novell only
checks the first 32 objects in the
SECURITY_EQUALS property to determine
trustee rights. The other part is that
if you have both types of groups, the
number of groups becomes unwieldy when
adding and deleting users and programs.
Please note that this classification of
groups as operational and application is
purely contrived and not part of Novell.
Trustee Rights: The Mnu does not make any provisions for
trustee rights assignment; i.e., in the
previous example, we had to use SysCon
to assign the trustee rights for the
accounting data.
DOS Security: The Mnu is not an airtight shell over
DOS -- if a user knows something about
DOS, they can Ctrl-Break out of a Batch
option and get at the DOS command line.
If this is a large problem, let us know
and we will consider implementing some
safeguards. If you have sensitive files,
use Novell's trustee rights to protect
them.
Execution Method: The Exec execution method is probably
the best overall method. It provides
very low memory overhead, reasonably
fast execution speed and superb return
to the menu speed. Also, it is easier
on File Server usage than the Batch
method because it does not reread the
Menu/Item information when the item is
finished executing
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 49
Appendix E - Technical Information
----------------------------------
Bindery Usage
The Mnu uses the bindery to store all of its data and uses
standard Novell function calls to manipulate and access the data.
The object types used are outside of the range reserved by
Novell. Specifically, the following object types are used:
8000h Control
8001h Menu
8002h Item
8003h Program
Environment variables
MNU_SEARCH Drive to use as program's search drive. Must
be mapped as a search drive. (default X
mapped as S1:)
MNU_WORK Drive letter to use as work drive for menu.
(default W)
MNU_USER Drive letter to use as user drive for
relative data drive maps.
MNU_STATION Connection# of station
MNU_VIDEO Controls snow checking and forces BW with
color video adapter.
CGA Snow & BW w/Color Video
The Mnu automatically detects your video adapter. It will only
do snow checking if it detects a CGA card, although you may
override this with the MNU_VIDEO env var. It will automatically
use color with a color-capable video adapter, again you can
override this with the MNU_VIDEO env var. The only time you
should need to use the MNU_VIDEO env var is with CGA cards, such
as Compaq's and a composite monitor on a CGA. It should auto-
detect mono/color with EGA and VGA.
MNU_VIDEO=xyz
x Color 1 to force BW (for use w/CGA w/ mono
monitor, not needed otherwise)
y Snow 1 to force no-snow checking (for use
with CGA that do not need chk)
z UseBios 1 to force BIOS video access.
For all parameters any other character will cause default
value to be used for that parameter. Also, any missing
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 50
values will cause the default to be used.
If the MNU_VIDEO envvar is not present, defaults will be
used.
Example: A BW monitor on an IBM CGA
SET MNU_VIDEO=11
Note that snow checking will be the default, but we specify
it anyway.
We could say, with the same results:
SET MNU_VIDEO=1X
Example: A CGA card that detects as a CGA but does not need snow
chk
SET MNU_VIDEO=X0
The following are the defaults, note that UseBios is always No:
Snow Color
MDA N N Monochrome Display Adapter(IBM)
EGAMONO N N EGA w/Monochrome Monitor
MCGAMONO N N MCGA w/Monochrome Monitor
VGAMONO N N VGA w/Monochrome Monitor
HGC N N Hercules Mono w/Monochrome Monitor
HGCPLUS N N Hercules Mono Plus w/Monochrome Monitor
INCOLOR N Y Hercules InColor w/Color Monitor
CGA Y Y CGA w/Color Monitor
EGA N Y EGA w/Color Monitor
MCGA N Y MCGA w/Color Monitor
VGA N Y VGA w/Color Monitor
License Control
License control is effected with semaphore locking, thus if the
file server is downed or a station goes down, the license
metering takes care of itself. Note that to use license metering
you must use either the Shell or Exec execution methods (with
their associated memory overheads).
Work Files
The Mnu Work directory is used to write temporary files during
execution. The possible files are:
MNU$GXXX.BAT batch file containing instructions for Exec
and Batch methods.
MNU$RXXX.RST file containing restart information to allow
the mnu to return to the same menu & item
after execution of an item.
MNU$DXXX.MAP file containing information on the drive
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 51
mapping before an item was executed to allow
restoration of the drive mapping.
MNU$SXXX.SWP file containing swapped out application
memory for Exec method.
Note that XXX is replaced by the setting of MNU_STATION (usually
the connection number). These file are deleted automatically by
the mnu.
Dos Versions
Because The Mnu uses the DOS Batch command "call", it requires at
least dos 3.3. It should function correctly with Dos 4.0, but it
has not been tested yet (let me know if you've tried it!).
Netware Versions
The Mnu was designed for Netware v2.1x. It has been successfully
tested with 2.10,2.11,2.12 and 2.15. It may run with 2.0a, but
it has not been tested (again, let me know if you've tried it).
Also, it has not been tested with NW 386 3.x, but it should run
if Novell didn't change the API too much. Future versions WILL
support NW 386 3.x fully, including the "fake root" capabilities.
Multiple File Servers
The Mnu will appropriately handle saving and restoring mapped
drives when you are attached to multiple file servers. However,
you may specify Search Paths or Drive Mappings only on the
default file server. Future versions of The Mnu will fully
support multiple file servers, for now, use MAP.EXE in your item
instructions to map drives to other file servers.
Item Execution
The following is description of what happens during Item
Execution, after an item is selected from the menu:
Shell, Shell & Pause
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) set default drive
6) save screen in memory
7) clear screen and dump header (executing item:)
8) if pgm used has licenses>0, open and check
semaphore, if license exceeded, abort execution.
9) shell to command.com, pass first line of
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 52
instructions as command line
10) if Shell&Pause, disp msg & wait for keystroke
11) unlock semaphore, if used.
11) restore screen from memory
12) restore default drive and drive mappings from
memory
13) continue menu processing
Exec:
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) Open MNU$Mxxx.MAP
6) Open MNU$Gxxx.BAT
7) write saved drive mapppings to MNU$Mxxx.MAP
8) write default drive change to MNU$Gxxx.BAT
9) write instruction to MNU$Gxxx.BAT
10) write saved default drive change to MNU$Gxxx.BAT
11) close MNU$Mxxx.MAP & MNU$Gxxx.BAT
12) save screen to memory
13) if pgm used has licenses>0, open and check
semaphore, if license exceeded, abort execution.
14) clear screen and dump header (executing item:)
15) swap out application memory to MNU$Sxxx.SWP
16) shell to command.com, pass MNU$Gxxx.BAT as command
line.
17) swap pgm memory in from MNU$Sxxx.SWP
18) delete MNU$Sxxx.SWP
19) unlock semaphore, if used.
20) restore screen from memory
21) restore drive mappings from memory
22) restore screen from memory
23) continue menu processing
Batch:
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) Open MNU$Rxxx.RST
6) Write restart information to MNU$Rxxx.RST
7) close MNU$Rxxx.RST
8) Open MNU$Mxxx.MAP
9) write saved drive mapppings to MNU$Mxxx.MAP
10) close MNU$Mxxx.MAP
11) Open MNU$Gxxx.BAT
12) write default drive change to MNU$Gxxx.BAT
13) write instruction to MNU$Gxxx.BAT
14) write saved default drive change to MNU$Gxxx.BAT
15) close MNU$Gxxx.BAT
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 53
16) clear screen and dump header (executing item:)
17) exit with errorlevel 50 (MNU.BAT takes over now)
18) "call" MNU$Gxxx.BAT
19) execute MNU$MAIN.EXE
20) open MNU$Rxxx.RST
21) read restart info from MNU$Rxxx.RST
22) delete MNU$Rxxx.RST
23) open MNU$Mxxx.MAP
24) read saved drive mapping from MNU$Mxxx.MAP
25) close MNU$Mxxx.MAP
26) delete MNU$Mxxx.MAP
27) restore drive mappings
28) reread and realign using restart info
29) continue menu processing
Batch&Exit:
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) Open MNU$Gxxx.BAT
6) write default drive change to MNU$Gxxx.BAT
7) write instruction to MNU$Gxxx.BAT
8) close MNU$Gxxx.BAT
9) clear screen and dump header (executing item:)
10) exit with errorlevel 50 (MNU.BAT takes over now)
11) "call" MNU$Gxxx.BAT
12) terminate batch file (MNU.BAT)
Exit:
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) exit with errorlevel 50 (MNU.BAT takes over now)
6) terminate batch file (MNU.BAT)
Logout:
1) Save current drive mappings in memory
2) Save current drive in memory
3) if pgm used, do search path and drive mappings.
4) do item drive mappings
5) Open MNU$Gxxx.BAT
6) write default drive change to MNU$Gxxx.BAT
7) write instruction to MNU$Gxxx.BAT
8) close MNU$Gxxx.BAT
9) clear screen and dump header (executing item:)
10) exit with errorlevel 40 (MNU.BAT takes over now)
11) "call" MNU$Gxxx.BAT
12) change to drive Z: (MNU.BAT)
13) change directory to \login
14) "chain" to MNU$LOG.BAT
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix E - Technical Information Page 54
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix F - Cautions Page 55
Appendix F - Cautions
----------------------------------
Cautions on using The Mnu:
Be aware that The Mnu uses the Novell bindery to store its
information. The Mnu uses ONLY Novell documented API function
calls to access the bindery, so bindery integrity is not an
issue. The Mnu does manipulate some Novell defined objects,
specifically, Users and Groups. Every effort has been made to
assure that such manipulations are identical to those done by
SysCon. It is for this reason that MnuCon will not add or delete
Users -- there is just too much specialized info.
The other implication of The Mnu's use of the bindery is that to
backup your menu configuration you must back up the bindery.
Use of third-party object types Use of third-party object types
The menu uses object type 8000h through 8004h. These object type
are specified by Novell for use by third party applications. If
you are already using an application that uses these object
types, do NOT use The Mnu -- contact us for further information.
This should be a very rare occurrence, at present we are not
aware of any other programs that use these object types.
If you are not sure if you are using such an application, be sure
you run BINDFIX before installing the Mnu (this step is included
in the installation instructions, and should be done for prudence
anyway). Then, if either The Mnu or your application do not
operate correctly, simple run BINDREST to restore the bindery to
its previous state. Also, MnuInst checks the bindery for third-
party object types and warns you of their presence before making
any changes to the bindery.
Use of BINDFIX/BINDREST on an installed system Use of BINDFIX/BINDREST on an installed system
The operation of BINDFIX and BINDREST are unaffected by the
presence of absence menu information. Actually, because menu
information is stored in the bindery according to Novell
specifications, BINDFIX and BINDREST actually "understand" the
menu information enough to handle it correctly.
Bindery limit on objects and properties Bindery limit on objects and properties
The bindery has a limit of approximately 65000 objects and
properties, one a large install of 20 menus, 150 items and 50
programs, The Mnu will use approximately 1500 of these objects
and properties. While this will not even come close to pushing
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix F - Cautions Page 56
the limit, you may see a small degradation in the performance of
utilities such as SysCon.
One other note regarding the evaluation period. As specified in
the License Agreement, you may evaluate the product for 21 days.
The Mnu records the date of installation (when Install the Mnu
was run in MNUINST) and will print the number of days since it
was been installed each time the program has been run (until it
is registered. After the 21 day evaluation period has expired,
the programs will print a warning message informing you that the
evaluation period has expired. The programs WILL continue to
work indefinitely, although you are still obligated to register.
Note that you may DeInstall the program in or out of the
evaluation period with MNUINST. Also, whenever you exit from
MnuCon, you will be presented with information regarding the
shareware status of the program and be asked if you would like to
print a registration form. This screen and question are not
presented after the program has been registered.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix G - Installation Page 57
Appendix G - Installation
----------------------------------
The Mnu Installation Instructions
The Mnu including all of its program files and documentation is
Copyright (c) 1989 by Bonsai Technologies. All rights reserved.
Note: You MUST be running PC or MS DOS 3.3 to use The Mnu.
Note: The Mnu was written for Netware v2.1x. It is known to
operate correctly on 2.1x versions(2.10,2.11,2.12,2.15). It
should also operate correctly on v2.0a -- however Bonsai
Technologies has not verified this.
Installation and Configuration of The Mnu is not a trivial task
if you are not familiar with both DOS and Novell. If you are not
familiar with both DOS and Novell, we recommend that you enlist
the services of someone who is.
1) Read the file LICENSE.DOC and agree to the terms
presented for non-registered users.
2) Login as SUPERVISOR or equivalent.
3) Copy MNUCON.EXE, MNU$HLP.HLP, MNU.BAT, MNU$EXEC.EXE,
MNU$MAIN.EXE and MNUINST.EXE to SYS:PUBLIC. Flag these
files as Shareable Read-Only.
4) Copy MNU$LOG.BAT to SYS:LOGIN and flag as Shareable
Read-Only. Also, make sure the group EVERYONE has ROS
rights to SYS:LOGIN.
5) Run BINDFIX in SYS:SYSTEM to backup the bindery files.
This step is necessary to allow you to restore your
system to its original state in the unlikely event that
you are using another application that uses the same
non-standard object types as The Mnu.
6) Create a work directory for The Mnu and give EVERYONE
all rights except parental to it. We suggest that the
work directory be SYS:MNU_WORK.
7) Modify the system login script. The Mnu must have a
drive mapped out to its work directory. Also, the
environment variables must be set if the defaults are
not used. Here is a sample script:
MAP F:=SYS:USERS\%LOGIN_NAME
MAP S1:=SYS:PUBLIC
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix G - Installation Page 58
MAP S2:=SYS:PUBLIC\%MACHINE\%OS\%OS_VERSION
MAP ins S1:=SYS:APPS
MAP W:=SYS:MNU_WORK
SET MNU_STATION=STATION
* These values are defaults, but we'll set them
* anyway.
SET MNU_WORK="W"
SET MNU_SEARCH="X"
SET MNU_USER="F"
See the Installation Reference section of the manual
for more information. Please note the MNU_WORK
environment variable must _always_ be set. Also note
that the syntax given is correct for Novell login
scripts, if you are setting the env vars from a batch
file, omit the "s (SET MNU_WORK=W).
8) Run MNUINST and select Install The Mnu.
9) Run MNUCON.
a) Use Menu Information to create a base menu. We
suggest that you name it BASE_MENU, put in your
company name as the Description and make EVERYONE
an Authorized Object.
b) Use Other Information to set options. Set Base
Menu to the menu created in #7(BASE_MENU). Set the
Allow User Authorization and Allow Escape to DOS
as desired. See the Other Information section of
the manual for more information on these options.
c) Create a Logout item: use Item Information to
create an item named LOGOUT per the following:
Description Logout
Authorized Groups EVERYONE
Menus Used In BASE_MENU
Execution Method Logout
10) The Mnu is now useable. If you wish users to load the
menu automatically when they login, put the command
EXIT "MNU" in each user's login script.
11) You may now create your full menu structure with
MnuCon. Please note that you must be SUPERVISOR or
equivalent to run MnuCon.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix H - Future Enhancements Page 59
Appendix H - Future Enhancements
----------------------------------
The Mnu is continually evolving. The following is a list of
possible enhancements for future versions. If any of these
appeal to you, please let me know. Also, let me know if you have
any specific ideas of how you would prefer to see these
implemented.
Automatic printer selection/capture.
Automatic hardware detection (video,mouse etc) for programs!
Monitoring utility.
Import/Export of menu structures.
Usage logging.
Elimination of the MNU_xxx environment variables
Elimination of need for pre-done drive mappings for
MNU_WORK, MNU_SEARCH and MNU_USER.
Color choices avail globally and by menu.
Definable help for menus/items.
A version for use on stand-alone machines.
We appreciate any comments and suggestions, especially those
regarding features you would like to see in The Mnu.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix I - Version History Page 60
Appendix I - Version History
----------------------------------
14Dec89 v1.26
Time-limit has been removed. Programs will now work
indefinitely. Previous versions would cease functioning 75
days after installation if not registered (this fact was
present in the documentation and presented on the sign-on
screen).
01Nov89 v1.25
Bugs fixed:
MNU$EXEC.EXE would crash if a large dos environment was
present. MNU$EXEC.EXE has been eliminated and the current
method for Exec handles environments of any size (tho a
large environment will increase the memory overhead).
When executing a submenu, the selection bar stayed visible
on the parent menu. v1.25 highlights the submenu choice on
the parent menu, leaving the selection bar visible only on
the current menu.
Snow checking for CGA. v1.24 never did any snow checking, no
matter what. v1.25 now does snow checking with CGA, although
this may be overridden with the MNU_VIDEO env var.
v1.24 would always use color with a color-capable video
adapter. This would cause problems with CGA & composite
monitors and with Compaq's. The use of color may be
overridden the MNU_VIDEO env var.
v1.24 was time limited to approx 70 days, however this fact
was never explicitly stated in the docs. Also, no warning
was given when your evaluation period was about to expire.
v1.25 displays how many days into the evaluation period you
are and also counts down the last 15 days of program
operation after the evaluation period has expired.
New Features
Connection Number is optionally displayed in title block.
Menus may now (optionally) be separated from Items when
displayed.
Logout Item - executes instructions before ending with
MNU$LOG.BAT
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix I - Version History Page 61
Exec Item - no longer uses MNU$EXEC, decreases memory
requirements to about 10k
Screen-Saver and Automatic Logout available
Instructions may prompt for user input
Drive mappings are saved/restored correctly with multiple
file servers. Note that you CANNOT specify Drive Mappings
and Search Paths on other file servers. You must use the
novell MAP command in the Instructions to map a drive to a
file server other than the default.
Novell Users and Groups may be manipulated while in MnuCon.
Instruction Edit window is larger so that long lines may be
read directly.
Reports menu is new.
Summary options have been rewritten and now include complete
info.
Programs now know which items they are used in (used in
reporting only).
A screen location may be specified for menus.
12Sep89 v1.24 First shareware release of The Mnu!
Also see the file VERSION.TXT for information regarding revison
levels for each program.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix J - System Config Report Page 62
Appendix J - System Config Report
----------------------------------
See the file APPNDX_J.TXT for the System Configuration Report.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
Appendix K - Upgrade Instructions Page 63
Appendix K - Upgrade Instructions
----------------------------------
General upgrade instructions
1) Backup the bindery (just in case).
2) Copy the new program files into SYS:PUBLIC, this will
include MNU$MAIN.EXE, MNU.BAT, MNUCON.EXE, MNUINST.EXE
and MNU$HLP.HLP. Also, copy MNU$LOG.BAT into
SYS:LOGIN.
3) Run MnuInst and select the Upgrade option.
4) Everything will now work as it did before (or better!),
take a look at the Version History appendix in the
manual to see what's new!
Note that it is NOT necessary to have the users log-off while an
upgrade is performed. However, be aware that it is possible for
an old version program to become somewhat confused when there is
a new version data. At worst, this will cause an error for a
user executing a menu. Logging out an back in will cure any
difficulties that might occure. Note that there is NO possiblity
of such problems affecting users who are in application programs,
although they may encounter difficulties when the menu tries to
reload AFTER the application is finished.
Extra Note for those upgrading from The Mnu v1.24
The Mnu v1.24 used an extra program (MNU$EXEC.EXE) for use with
Exec method Items. This program is obsolete beginning with
v1.25. While leaving the program in PUBLIC will not cause any
problems, it is no longer used and may be deleted.
The Mnu v1.26
Copyright 1989 Bonsai Technologies. All rights reserved.
